/**
 * Copyright (c) 2008 Luciano Bustos - riaevolution.com, All Rights Reserved.
 * 
 * Contact luchyx@riaevolution.com
 * See www.riaevolution.com
 *  
 * Permission is hereby granted, free of charge, to any person obtaining a copy of 
 * this software and associated documentation files (the "Software"), to deal in 
 * the Software without restriction, including without limitation the rights to
 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
 * of the Software, and to permit persons to whom the Software is furnished to do
 * so, subject to the following conditions:
 * 
 * The above copyright notice and this permission notice shall be included in all 
 * copies or substantial portions of the Software.
 * 
 * 
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE. 
 * */
package com.riaevolution.cairngorm.view
{
	/**
	 * IViewNotificable allows any UIComponent that implement it to receive notifications direct from result or fault event catched by INotificableCommand.
	 * <listing>
	 * public function notifyStatus(type:String, result:Object):void {}
	 * public function notifyResult(result:Object):void {}
	 * public function notifyFault(fault:Object):void {}
	 * public function get view():Object {}
	 * </listing>
	 * 
	 * @see com.riaevolution.cairngorm.commands.INotificableCommand
	 * @author luciano bustos
	 * */
	public interface IViewNotificable
	{
		/**
		 * notifyStatus is usefull if you need to execute a directly method on the IViewNotificable
		 *  
	 	 * @param action String a status type or common action that shoul change the current view.
		 * @param data Object custom object know by the implementation
		 */
		function notifyStatus(type:String, result:Object):void;
		/**
		 * Usualmente notifica el resultado de la operacion 
		 * @param result usualmente un ResultEvent
		 */		
		function notifyResult(result:Object):void;
		/**
		 * Para notificar la falla de una operacion a la vista. 
		 * @param fault usualmente un FaultEvent.
		 * 
		 */		
		function notifyFault(fault:Object):void;
		/**
		 * This getter allow us to get the current view.
		 * 
		 * @return Object 
		 **/
		function get view():Object;
	}
}